filter: Cosmetic docs changes

docs: Refer to backend APIs

Add links to the backend api docs.

docs: Fix a typo

docs: Avoid stairstepping

If you don't put empty lines between the items in a
definition list, markdown helpfully stairsteps them.
We don't want that!

docs: Update GSK_RENDERER docs

This did not mention the opengl and ngl values yet.

gtk: Clean up docs syntax

Replace leftover gtk-doc syntax (#Type) with backquotes.

gsk: Clean up docs syntax

Replace leftover gtk-doc syntax (#Type) with backquotes.

gdk: Clean up docs syntax

Replace leftover gtk-doc syntax (#Type) with backquotes.

docs: Clean up docs syntax

Replace leftover gtk-doc syntax (#Type) with backquotes.

demos: Clean up doc comments

These don't show up anywhere, but might still clean
them up.

Merge branch 'wip/exalm/check-activate' into 'master'

checkbutton: Don't allow to uncheck radios by activating them

See merge request GNOME/gtk!3569

Merge branch 'doc-tweaks' into 'master'

Fix documentation syntax

See merge request GNOME/gtk!3572

docs: Reduce redundancy

Remove a boatload of "or %NULL" from nullable parameters
and return values. gi-docgen generates suitable text from
the annotation that we don't need to duplicate.

This adds a few missing nullable annotations too.

introspection: Stop using allow-none

allow-none has been deprecated for a long time
already. Instead use optional and nullable everywhere.

Documentation fixes

Mostly fixing up indentation of continuation lines,
and other small cleanups.

Fix documentation syntax

Properties use : in their link syntax.

Merge branch 'wip/exalm/switch-icons-2' into 'master'

icons: Fix switch-off icon

See merge request GNOME/gtk!3571

icons: Fix switch-off icon

It wasn't converted to paths and so wasn't rendered correctly.

Merge branch 'popover-docs' into 'master'

popover: Update docs

Closes #3960

See merge request GNOME/gtk!3570

popover: Update docs

Remove mention of show/hide animations, and mention
cascading close instead.

Fixes: #3960

checkbutton: Don't allow to uncheck radios by activating them

Do the same check as when clicking.

Update Ukrainian translation

Update Ukrainian translation

Merge branch 'bilelmoussaoui/gdk-return-error-annotation' into 'master'

gdk: annotate Content Serialize/Deserialize return_error

See merge request GNOME/gtk!3567

gdk: annotate Content Serialize/Deserialize return_error

Merge branch 'fix-gst-media-file' into 'master'

gtkgstmediafile: Remove media-info-updated callback

Closes #3913

See merge request GNOME/gtk!3565

gtkgstmediafile: Remove media-info-updated callback

Instead, rely on position-updated which is also called always, and also
a little later than media-info-updated, giving GstPlayer time to figure
out more of the video info. Tested on local and remote mount videos,
images, sound files.

Works around / fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3913,
https://gitlab.gnome.org/GNOME/gtk/-/issues/3914.

Merge branch 'matthiasc/for-master' into 'master'

Actually pass the devel profile to flatpak builds

See merge request GNOME/gtk!3563

Actually pass the devel profile to flatpak builds

I added that to the manifests, and did not notice that
we do the last build step manually :(

Merge branch 'wip/carlosg/sequence-accepted-in-group' into 'master'

gtkgesture: Apply gesture group state after setting up sequence

Closes #3946

See merge request GNOME/gtk!3560

Merge branch 'fix-gen-demo-conf' into 'master'

Fix generating demo_conf.h on builds without GIT in PATH

See merge request GNOME/gtk!3562

gen-demo-header.py: Fix running without git

The script assumes that the git program is in the PATH which may not be always
the case, so if git was not found, fallback to the former behavior of making
VCS_TAG an empty string if the profile option was not set to 'devel'.

Also fix the call to the script so that we do indeed call GIT on the source GIT
repo so that we can get the right short SHA1 sum.

Re-organize the code a bit in the process, so that things seem cleaner.

Merge branch 'wip/carlosg/reset-after-grab' into 'master'

Fixes to GTK grab notification

Closes #3942

See merge request GNOME/gtk!3561

gtkwindow: Fix "shadowed" checks for GTK grabs

We iterate here from the target widget up the toplevel checking
for the previous and new grab, there's however 2 bugs here:
- The check for is_shadowed was different to the check for was_shadowed
- The loop started with the assumption that the widgets did not hold
  a grab, just to change it if the grab widget was found. (or maybe
  it's the other way around? it's unclear with the differing checks
  for past/present state).

Make these checks consistent, and ensure we start with the right
assumption for the past/present grabbing state, and accounting that
new/old grab widgets may or may not be part of the pick stack.

gtkwindow: Rename function

With gtk_grab_notify_foreach() just taking care of emitting crossing
notifications due to the GTK grab change, rename it to a more apt
gtk_synthesize_grab_crossing().

gtkwindow: Simplify GTK grab notification

The _gtk_widget_grab_notify() function just (maybe) did a) reset
controllers and b) hide toplevels. The second part was a testing
remnant introduced in commit 024d832d943, not part of the original
fix.

Do the former more concisely, called from the place where we figure
out whether a widget's ability to receive events changed due to
GTK grabs. It's across those changes that we are interested in
resetting the controllers.

With the gestures being reset both ways, GtkWindowHandle (and
probably other) gestures are now able to reset after a GTK grab
takes input away (e.g. GtkMenuButton). This could be seen as
a sudden jump the next time they'd be dragged with the mouse,
as the gesture would "resume" the previous interaction.

Fixes: https://gitlab.gnome.org/GNOME/gtk/-/issues/3942

gtkgesture: Apply gesture group state after setting up sequence

When a new sequence is added to a GtkGesture, its state is looked
in other gestures in the same group, and made to match in this
gesture. This however happened a bit too early, before the
gesture touchpoint was fully set up. As this may result in signal
emission and whatnot, it's a good idea to make it happen with a
fully set up touchpoint.

Fixes: https://gitlab.gnome.org/GNOME/gtk/-/issues/3946

Merge branch 'ebassi/rev-parse-fallback' into 'master'

build: Check CI envvars before rev-parse

See merge request GNOME/gtk!3559

build: Check CI envvars before rev-parse

The CI pipeline does not do a full clone, so we cannot use `git
rev-parse` to get the short SHA checksum for the current commit.

Of course, since nothing's ever easy, we cannot use vcs_tag() with a
custom command, so we need to generate our out `demo_conf.h` header
straight from a script.

Merge branch 'wip/exalm/activatable2' into 'master'

theme: Specificity bump for dropdowns

See merge request GNOME/gtk!3558

theme: Specificity bump for dropdowns

Fix a fallout from d56711b5d82f8a77793a0857c2252565fda1b492

Merge branch 'wip/exalm/activatable' into 'master'

listitemwidget: Have .activatable style class if the item is activatable

See merge request GNOME/gtk!3557

listitemwidget: Have .activatable style class if the item is activatable

Match GtkListBox, so it's possible to use the same styles for them.

Update GtkListView and GtkGridView docs to reflect that, fix a few gtk-doc
formatting leftovers along the way.

Merge branch 'matthiasc/for-master' into 'master'

ngl: Add padding between cached glyphs

See merge request GNOME/gtk!3555

testsuite: Run some installed tests exclusively

My suspicion is that the clipboard (and some other)
installed test interferes with others, because the
clipboard is a shared resource.

Merge branch 'wip/exalm/emojichooser' into 'master'

emojichooser: Set selection-mode=none on the toolbar flowbox

See merge request GNOME/gtk!3556

emojichooser: Set selection-mode=none on the toolbar flowbox

Selection is never used there, avoid unwanted selected states if clicking
outside the buttons.

Update Nepali translation

(cherry picked from commit 597a624fc55975513517aa5514e5f4b3d838745e)

ngl: Reuse texture coordinates

When uploading glyphs, reuse the position that
we get from gsk_ngl_texture_library_pack, instead
of recomputing it.

ngl: Be consistent about padding

Make gsk_ngl_texture_library_pack always return
the position including the padding. And compute
texture coordinates accurately in all cases (we
were fudging the padding for standalone textures.

ngl: Add padding between cached glyphs

Without this, adjacent items in the cache sometimes
bleed into the texture for a glyph.

Merge branch 'gst-egl-optional' into 'master'

meson: Do not enforce GStreamer EGL lib

See merge request GNOME/gtk!3554

meson: Do not enforce GStreamer EGL lib

GStreamer EGL headers are handled by GstGL lib.
No need to additionally import them.

Update Norwegian Bokmål translation

(cherry picked from commit d952fa48e783cfdd82c7a1a3191f1eb59ed6ad27)

Merge branch 'gst-x11-egl' into 'master'

gtkgstsink: Support EGL under x11

See merge request GNOME/gtk!3553

gtkgstsink: Support EGL under x11

Add support for EGL under x11 windowing system to GStreamer sink

Merge branch 'ebassi/issue-3948' into 'master'

x11: Loosen the match for the NVIDIA driver

Closes #3948

See merge request GNOME/gtk!3549

Merge branch 'matthiasc/for-master' into 'master'

inspector: Use new get_egl_display apis

See merge request GNOME/gtk!3546

Merge branch 'offscreen-fixes' into 'master'

Add some more transform tests

See merge request GNOME/gtk!3551

Improve transformed offscreen rendering

Preserve the scale for 2D transforms to
avoid a pixellated appearance.

Add some more transform tests

Test that gsk_transform_to_affine works.

testzoom: Fix the in-place rotate

inspector: Use new get_egl_display apis

This makes the code a bit more concise.

Also, get WGL information when we are using it.

x11: Pair eglInitialize with eglTerminate

If we bail out after EGL initialization we want to go back to a stable
state and not leave EGL hanging.

x11: Loosen the match for the NVIDIA driver

It seems nVidia puts a different string in the GL_VENDOR than the one it
uses for GLX.

Merge branch 'ebassi/boost-url' into 'master'

Update the URL for the Boost archive

See merge request GNOME/gtk!3548

Update the URL for the Boost archive

The old URL seems to have failed, and now it returns 301.

Use the URL from the Boost website.

Merge branch 'fix-picking-with-transforms' into 'master'

Fix picking with transforms

See merge request GNOME/gtk!3547

Add a transform test

This reveals some issues with scale handling.

Fix picking with transforms

When transforms include scales, we weren't picking
children properly. The special-case in gtk_widget_do_pick
only applies to 2D translations.

Merge branch 'ebassi/issue-3945' into 'master'

docs: Fix indentation of the arguments

Closes #3945

See merge request GNOME/gtk!3544

Merge branch 'wip/chergert/fix-gi-typo' into 'master'

gdk: fix typo in G-I attribute

See merge request GNOME/gtk!3545

Merge branch 'win32.egl.getter' into 'master'

Win32: Add EGLDisplay getter

See merge request GNOME/gtk!3543

gdk: fix typo in G-I attribute

docs: Fix indentation of the arguments

The indentation of new lines inside documentation blurbs must be smaller
than 4 spaces, otherwise the Markdown parser will consider the line to
be part of a pre-formatted code block.

Fixes: #3945

Win32: Add EGLDisplay getter

Like what was done for Wayland and X11, add an API to retrieve the EGLDisplay
if one is being used in place of WGL.

Merge branch 'ebassi/egl-display-get' into 'master'

Add backend-specific getter for the EGLDisplay

See merge request GNOME/gtk!3542

wayland: Add EGLDisplay getter

Getting an EGLDisplay object is messy; might as well expose the function
we use internally to save some time, just like we did for the X11
backend.

x11: Add EGLDisplay getter

Getting an EGLDisplay object is messy; might as well expose the function
we use internally to save some time.

build: Do not use C arguments with C++

Otherwise the C++ compiler will start to complain.

The C++ keyword test does not need additional warnings.

Merge branch 'misc-inspector-things' into 'master'

inspector: Show text direction

See merge request GNOME/gtk!3541

inspector: Avoid a crash with GL variants

When configuring the inspector display, preserve
debug flags that affect which GL variant we pick.
Otherwise, we may end up with a GLX context on the
default display, and an EGL context on the inspector
one. This hopelessly confuses libepoxy, and things
don't go well when that happens.

inspector: Show EGL info for X11 as well

inspector: Show text direction

This is not a property, so show it on the misc tab.

Merge branch 'ebassi/egl-x11' into 'master'

Prefer EGL to GLX for the GL support on X11

See merge request GNOME/gtk!3540

x11: Don't update GLX visuals with EGL

We're going to get into a messy situation, with both GLX and EGL
initialized.

If we're already using EGL, skip the whole cache.

Merge branch 'broadway-display-scale' into 'master'

broadway: Add a setter for display scale

Closes #3934

See merge request GNOME/gtk!3538

x11: Always fall back to GLX on NVIDIA

At least until we can guarantee that EGL-X11 works fine there.

x11: Move the damage fences into the GLX code

It's GLX-specific anyway, there's no need to complicate things by having
half the code in the generic path, and half in the GLX one.

x11: Add debug toggle for preferring GLX

Mostly as a way to compare the EGL and GLX implementations.

x11: Add profiler marks for SwapBuffers

x11: Use EGL for GL support

This makes the X11 backend similar to the Wayland one, when it comes to
OpenGL.

Fall back to GLX only if EGL support is not available.

x11: Decouple GLX from GdkX11GLContext

If we want to add an EGL implementation for the X11 backend, we are
going to need to move the GLX bits into their own class. The first step
is to declare GdkX11GLContext as an abstract type, and then subclass it
into a GdkX11GLContextGLX type, which includes the whole GLX
implementation.

inspector: Support scale changes on Broadway

Merge branch 'ci-more-clang' into 'master'

ci: Add clang-extra-tools to the image

See merge request GNOME/gtk!3539

ci: Add clang-extra-tools to the image

Hurray for bite-size packages! Splitting
this off broke our style check in ci.

broadway: Add a setter for display scale

This is useful when using Broadway as a headless
display server.

Fixes: #3934

Cosmetics

Merge branch 'file-replace-trap' into 'master'

print-editor: Fix saving

See merge request GNOME/gtk!3536

Merge branch 'wip/exalm/image-button' into 'master'

Ensure consistent header bar buttons in the demo and tests

See merge request GNOME/gtk!3537